one or more gamma maps. Servers may assign a permanent
gamma map to a channel, restrict channels to use one of a
subset of all maps, permit a channel to use one of all
shared maps, or some combination thereof, depending on
hardware configuration. If two channels employ the same
gamma map, changing the colors in that gamma map will affect
both channels.
FFFFuuuunnnnccccttttiiiioooonnnnssss
XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyySSSSccccrrrreeeeeeeennnnGGGGaaaammmmmmmmaaaaMMMMaaaappppssss returns the number of separate
gamma maps supported. For each gamma map supported, the
system returns the number of entries supported. Each color
component in a gamma map must support the same number of
entries, different gamma maps may support different numbers
of entries. Systems with no writable gamma map should return
a count of zero (0). XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyGGGGaaaammmmmmmmaaaaMMMMaaaapppp returns information
regarding a specified gamma map's configuration.
The XXXXSSSSGGGGIIIIvvvvccccSSSSttttoooorrrreeeeGGGGaaaammmmmmmmaaaaCCCCoooolllloooorrrrssss8888 and XXXXSSSSGGGGIIIIvvvvccccSSSSttttoooorrrreeeeGGGGaaaammmmmmmmaaaaCCCCoooolllloooorrrrssss11116666
functions change the gamma map entries for the specified map
to the specified colors, the former function loading 8-bit
entries and the latter loading 16-bit entries. To load a
gamma color, you pass a single array of values via
_g_a_m_m_a_V_a_l_u_e and specify into which color components that
array will be loaded. The _d_o_R_e_d, _d_o_G_r_e_e_n, _d_o_B_l_u_eand _d_o_A_l_p_h_a
arguments indicate which components should actually be
changed. If you select more than one component, each
component will be loaded with the same values; you may
select any one or a combination of the colors to load.
N.B.: The hardware of some servers may require the server to
load all components simultaneously in an encoded (packed)
manner, so choosing a single color component may require the
server to query the gamma table to encode the component
before writing it; thus, the most efficient use of this
function may be to store all color components
simultaneously.
All tables loaded via a single call must have the same
number of entries, specified via the parameter _i_t_e_m_C_o_u_n_t.
Note that the count of the number of entries you load in a
table must exactly equal the length of the table (returned
via the parameter _g_a_m_m_a_S_i_z_e_R_e_t_u_r_n in the function
XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyGGGGaaaammmmmmmmaaaaMMMMaaaapppp, and XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyySSSSccccrrrreeeeeeeennnnGGGGaaaammmmmmmmaaaaMMMMaaaappppssss return
TRUE if successful, FALSE upon failure.
Parameter errors are reported via BadValue or BadMatch.
DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
In the XXXXSSSSGGGGIIIIvvvvccccSSSSttttoooorrrreeeeGGGGaaaammmmmmmmaaaaCCCCoooolllloooorrrrssss8888(((()))) and
XXXXSSSSGGGGIIIIvvvvccccSSSSttttoooorrrreeeeGGGGaaaammmmmmmmaaaaCCCCoooolllloooorrrrssss11116666(((()))) functions, a Value error is
generated if a specified pixel is not a valid index into the
gamma map. If more than one pixel is in error, it is
arbitrary as to which pixel is reported. A Colormap error
is generated if the map id is not valid.
In the XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyGGGGaaaammmmmmmmaaaaCCCCoooolllloooorrrrssss(((()))) function, a Colormap error
is generated if the gamma map id is invalid. A Value error
is generated if a pixel is invalid. If more than one pixel
is in error, it is arbitrary as to which pixel is reported.